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Preface 



This manual is a guide to the installation of DATATRIEVE-11 on the follow- 
ing operating systems: 

IAS V2.0 

RSX-11M V3.1 

RSTS/E V6C 

This manual is written for the system manager who is responsible for perform- 
ing the installation procedures. 

The information in this manual is organized in the following manner: 

Chapter 1 comments about the installation kit, describes how to physically 
mount the distribution media, and indicates errors that might occur during 
installation. 

Chapter 2 describes how to install DATATRIEVE-11 on an IAS system. 

Chapter 3 describes how to install DATATRIEVE-11 on an RSX-11M system. 

Chapter 4 describes how to install DATATRIEVE-11 on an RSTS/E system. 

Chapter 5 describes possible uses of the Data Dictionary Extend Program, 
extending DATATRIEVE-11 task space, and the Dictionary Compression 
Utility Program. 

Appendix A contains the Acceptance Test Procedure. 



Documentation Conventions 



The following conventions are used throughout this manual to illustrate the 
DATATRIEVE installation procedures: 

© The symbol ® represents the non-printing carriage 
return key. 

lower case Lower-case text indicates variable information that you 
UPPER CASE supply; upper-case text indicates literal information that 
you enter as shown. 

color Information that you type during the installation proce- 
dure is indicated in red. 

The circumflex (*) represents a control character. That 
is, Istrl/z) i s the same as 7. 



Chapter 1 

General Information 



i.i inaiaiiciiiGii r\n 

You receive a kit containing all material necessary to install 
DATATRIEVE-11 on the computer at your site. Check the contents against 
your original order. If there are any discrepancies between what you ordered 
and what your received, report the discrepancies to your sales representative. 

1.2 Physically Mounting Distribution Media 

1. For magtape distribution proceed as follows: 

a. Obtain the magtape from your kit and mount it on a free tape drive 
with the write enable ring removed. 

b. Ensure that the FILE PROT (file protection) indicator light is lit. 

c. Ensure that the tape is at its load point (the LD PT indicator light is 
lit). 

d. Set the ON LINE/OFF LINE switch on the tape unit to ON LINE, and 
ensure that the RDY (ready) indicator light is lit. 

2. For disk cartridge distribution proceed as follows: 

a. Obtain the disk cartridge from your kit and insert it into a free disk 
drive unit. 

b. Place either the LOAD/RUN switch for the RK05 or the RUN/STOP 
switch for the RK06 and RK07 to run position. Press the LOAD button 
on the RL01. 

c. Ensure that the RDY (ready) indicator light is lit. 

d. Ensure that the WR PROT (write protect) indicator light is lit. 
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1.3 Possible Errors during Installation 

When you are performing your installation procedures, you may get certain 
error messages. Should you get one of these messages, refer to this section. 

A possible error that can occur during the DATATRIEVE-11 installation is 
the failure of the QDICT program. If such an error occurs, the following 
message is printed on the terminal. 

RMS ERROR STATUS:xxx 

where xxx is an octal RMS error code. Refer to the IAS/RSX-11M RMS-11 
MACRO Programmer's Manual for the meaning of the error code and possible 
recovery procedures. When you have corrected the error, rerun the command 
file. 

If the following message appears: 

WRITE SHARING NOT AVAILABLE > PROCEEDING ANYWAY 

write-locking has not been installed on the system. The installation continues 
from this point; however, you must install write-locking and reinstall 
DATATRIEVE-11. A system generation may be required to install write- 
locking. With write-locking installed, you can rerun the command file. 

Another possible error is the termination of the QDICT task build. If the task 
build terminates with the following error message: 

TKB -- *DIAG*G UNDEFINED SYMBOLS SEGMENT SAVREG 

The most likely cause is that RMS-11K has not been installed. To determine 
whether or not RMS-11K has been installed, examine the QDICT.MAP file. 
If these symbols: 

$CL03E $CON3E 

$CRE3E $DIS3E 

$OPE3E $PUT3E 

are undefined, RMS-11K has not been installed on the system. 
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Chapter 2 

IAS V02 Installation Procedures 



This chapter is a guide to the installation of DATATRIEVE-11 on the IAS 
V02 Operating System. 

The information in this chapter is organized in the following manner. 

Section 2. 1 presents both the software and hardware requirements needed to 
install DATATRIEVE-11. 

Section 2.2 contains the procedures to install DATATRIEVE-11 on your 
system. 

Section 2.3 lists the DATATRIEVE-11 files that reside in the target UIC's. 



2.1 System Requirements 



The software and hardware listed in Sections 2.2.1 and 2.2.2 respectively are 
required to install DATATRIEVE-11. 

2.1.1 Software Requirements 

IAS Version 2 

RMS-11K Version 1 (for RMS Indexed Record I/O) 

RMS-11K software must be present on your computer prior to installing 
DATATRIEVE-11. If RMS-11K is not present, you must first install it before 
installing DATATRIEVE-11. Get the kit containing the RMS-11K software, 
and install this software following the procedures presented in the RMS-11K 
IAS Installation Guide. 
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2.1.2 Hardware Requirements 

The following system configuration is required for DATATRIEVE-11 
installation. 

CPU PDP-11 with EIS hardware. 

MEMORY 64K bytes above the minimum operating system requirements. 

TERMINAL Any supported terminal (hard copy terminals are preferred.) 

TAPE One 9-track magtape drive. 

or 

DISK RK05, RK06, RK07, or RL01 drive. 

DISK SPACE 2300 free blocks must be available in the target account for 
DATATRIEVE-11. 

2.2 Procedures for Installing DATATRIEVE-11 on IAS V02 

2.2.1 Summary of Installation Procedures 

1. Log in under a privileged account([l,x]). 

2. Physically mount the distribution medium as described in Chapter 1. 

3. Logically mount the distribution medium. 

4. Copy the distribution medium into your account (then remove the distri- 
bution medium). 

5. Execute the command file DTRIAS.CMD. 

6. Log off the system. 

2.2.2 Log in Under a Privileged Account 

Log into your computer system under a privileged account in the form ([l,x]). 

2.2.3 Logically Mount the Distribution Medium 

1. For magtape distribution use the command 

MQUNT/F0R/N00P dev: DTR11 © 

2. For disk cartridge distribution use the command 

M0UNT/N00P dev: DTR11 © 

where dev: is the device specification of the drive containing the distribution 
medium. 
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2.2.4 Copy the Distribution Medium 

1. To copy the data on the magtape into the target account type the command 

COPY dew: El »1]*.*/D0S *♦* (HD 

2. To copy the data on the disk cartridge into the target account type the 
command 

COPY d e v : C 1 * U * . * * . * © 



At this time, data on the distribution medium is copied into the target 
account, when the copying operation is complete, the prompt PDS> appears 
on your terminal. 

To logically dismount the distribution medium, type the command 



DISMOUNT deys (HD 

When the DISMOUNT COMPLETE message appears at your terminal, re- 
move the distribution medium and store it in a safe place. 

The installation dialog to this point will be similar to the following example 
(magtape distribution): 



PDS> MOUNT/FOR/NQOP MM1: DTR11 
MOUNT-**MOLUME INFORMATION** 

DEVICE =MMi 

CLASS =FOREIGN 

UIC =C1 »1] 

ACCESS =CRWED ,RWED >RWED »RWED] 

CHARAC =[FOR »ATCH*DCF] 

PDS>COPY MM1 : CI »U*.*/DOS *.* 

PDS> DISMOUNT MM1: 

DMO -- MM1: ** DISMOUNT COMPLETE ** 

PDS> 



2.2.5 Executing the Command File DTRIAS.CMD 

Now type: 

SDTRIAS © 

DTRIAS.CMD is the command file that installs DATATRIEVE-11 into your 
system. As part of the command file, the DATATRIEVE-11 Acceptance Test 
is executed. During the Acceptance Test, you are required to enter data. 
Observe the test as it outputs and respond as the test requests input. 
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The following example is the log printed as a result of command file execu- 
tion. Note that the Acceptance Test has been deleted from the example. The 
complete Acceptance Test is in Appendix A. 



PDS> SDTRIAS 
! 

! CREATE DATATRIEUE DIRECTORIES 
i 

REMOVE ***DTR 

REM •••- TASK ***DTR NOT IN SYSTEM 

CREATE /D I R LB : C 1 I t 1303 

C R E A T E / D .1. R L B t C 1 1 1 r 1 3 3 

CREATE/MR LB t C31 1 t .1 303 

COPY FILES TO PROPER LOCATIONS 

COPY QDI AS , MAC LB U 31 1 y 1. 301* . * 

DELETE QDI AS. MAC J* 

COPY QE I AS . LNK LB t C 1 1 r 1 303 * . * 

DELETE QE I AS. LNK?* 

COPY QEIAS.ODL LB: CI 1 t 1303*.* 

DELETE QEIAS.ODL?* 

COPY DTR I AS . ODL LB : C 1 1 , 1 303 * . * 

DELETE DTR I AS. ODL?* 

C P Y D T R I AS .LNK LB I C 1 1 r 1 3 3 * , * 

DELETE DTRl'AS.LNK?* 

C P Y R M S I A S * D L L B J 1 1 1 1 .!. 3 3 * , * 

DELETE RMSIAS.ODL?* 

COPY QC I AS. LNK LB J CI 1 , 1303*. * 

DELETE QC I AS. LNK?* 

COPY QC I AS. ODL LB X 1 1 1 * 1303* .* 

DELETE QC I AS. ODL?* 

INSTALL DATATRIEVE OBJECT LIBRARY 

M A C / B J : Q D L B t C 3 1 1 , 1 3 3 Q I.i I A S 

08 i 40 1 23 Si2e: 26K CPU J 0.1.1. Status: Success 

LI BR INSERT DTRLIB QD 

DELETE DTRLIB. OLE J* 
DELETE QD.OBJ?* 
! 

i INSTALL DATATRIEVE TASKS 
i 

0QDIAS.LNK 

LINK /OVERLAY t QDI AS /TASK * QDI CT /OPT/MAP i QDICT/READ 

08 Mi: 52 Size I 27K CPU J 22.10 Status J Success 
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RUN QDICT 

08 Mi t 54 

CREATING QUERY DICTIONARY 

CREATING MESSAGE FILE 

P P U L A T I N G M E S S A G E F I L E 

BYE 

08: 46: 22 SizeJ 2 IK CPU: 21*46 

@LB : C 1 1 r 1303DTRI AS * LNK 

L INK / U E R L A Y : L B J C J. 1 r I 303 D T R I A 5 - 

/TASK : LB J C 1 1 » 1 3DTR/0FT/MAP i LB : C 1 1 1 * 1 30 3DTR/MUL/READ 
08:51 : 45 Size: 27K CPU: 48.96 Status: Success 
@LB J C 1 1 » 1 30 .1 QE I AS * LNK 
LINK / V E R L A Y : L B J C 1 1 1 1 3 1 E I A S - 

/TASK : LB : L 1 1 f 1 ::iaDEXT/OPT/MAP : LB : Lilly 1 30:]QDEXT/READ 
08:52:31 Size: 27K CPU: 13.98 Status J Success 
! 

@lb : [.' 1 1 ? 1 30 :j qc i as • lnk 

l ink /overlay *. lb j c 1 1 r 1 30t.i qc ias - 

/task : lb j c 1 1 ? 1 dqcprs/opt/map t lb : c 1 1 1 » 1 30:iqcprs/read 

08:53:53 Size! 27K CPU: 26*60 Status I Success 
SET PROTECTION LB Hit 21 Q U E R Y * D I C U R I... D t U R E 
INSTALL LB; Lli y IJDTR 

I 

! RUN DATATRIEME ACCEPTANCE TEST 
i 

DTR GDTR.TST 



The DATATRIEVE-11 Acceptance Test Procedure 
is contained in Appendix A. 



EXIT 

BYE 

! 

! SAME YACHT DEMO FILE 
! 

COPY YACHT * DAT LB 1 1 1 1 2 1 * . * 
DELETE YACHT* DAT?* 

END OF DATATRIEME INSTALLATION 
PDS> 



2.2.6 Log Off the System 

Log off the system after the DTRIAS.CMD file has completed execution (you 
observe the PDS> prompt). 
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2.3 DATATRIEVE-11 Files 



When DATATRIEVE-11 has been installed, the following files reside in the 
indicated UIC's. Note that the [SELF] designation represents your privileged 
account. 



UIC FILE NAME 



DESCRIPTION 



[1,1] 


DTRLIB.OLB 


[1,2] 


QUERY.DIC 


[1,2] 


QUERY.MSG 


[1,2] 


YACHT.DAT 


[11,130] 


DTRIAS.LNK 


[11,130] 


DTRIAS.ODL 


[11,130] 


QCIAS.LNK 


[11,130] 


QCIAS.ODL 


[11,130] 


QEIAS.LNK 


[11,130] 


QEIAS.ODL 


[11,130] 


RMSIAS.ODL 


[11,1] 


DTR.TSK 


[11,1] 


QCPRS.TSK 


[11,1] 


QDEXT.TSK 


[111,130] 


DTR.MAP 


[111,130] 


QCPRS.MAP 


[111,130] 


QDEXT.MAP 


[311,130] 


QDIAS.MAC 


[SELF] 


DTR.TST 


[SELF] 


MSGS.SEQ 


[SELF] 


QDIAS.LNK 


[SELF] 


QDIAS.ODL 


[SELF] 


QDICT.MAP 


[SELF] 


QDICT.TSK 


[SELF] 


YACHT. SEQ 



Datatrieve object library 

Data dictionary 

Message file 

Acceptance test data file 

Datatrieve task-build command file 

Datatrieve overlay description file 

COMPRESS program task-build command file 

COMPRESS program overlay description file 

EXTEND program task-build command file 

EXTEND program overlay description file 

RMS overlay description file 

Datatrieve task image 

Dictionary COMPRESS program 

Dictionary EXTEND program 

Datatrieve map file 

Dictionary COMPRESS program map file 

Dictionary EXTEND program map file 

Dictionary file-name source module 

Acceptance test command file 

Message file (distribution format) 

Dictionary build program task-build command file 

Dictionary build program overlay description file 

Dictionary build program map file 

Dictionary build program 

Acceptance test data file (distribution format) 
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Chapter 3 

RSX-11M V03 Installation Procedures 



This chapter is a guide to the installation of DATATRIEVE-11 on the 
RSX-11M V03.1 Operating System. 

The information in this chapter is organized in the following manner: 

Section 3. 1 presents both the software and hardware requirements needed to 
install DATATRIEVE-11 

Section 3.2 contains the procedures to install DATATRIEVE-11 on your system. 
Section 3.3 lists the DATATRIEVE-11 files that reside in the target UIC's. 



3.1 System Requirements 



The software and hardware listed in Section 3.1.1 and 3.1.2 respectively are 
required to install DATATRIEVE-11. 

3.1.1 Software Requirements 

RSX-11M Version 3.1 Mapped System 

RMS-11K Version 1.5 (for RMS Indexed Record I/O) 

RMS-11K Software must be present on your computer prior to installing 
DATATRIEVE-11. If RMS-11K is not present, you must first install it before 
installing DATATRIEVE-11. Get the kit containing the RMSll-K software, 
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and install this software following the procedures presented in the RMS-11K 
RSX-11M Installation Guide. 



3.1.2 Hardware Requirements 

The following system configuration is required for DATATRIEVE-11 
installation. 

CPU PDP-11 with EIS hardware. 

MEM ORY 64K bytes above the minimum operating system requirements . 

TERMINAL Any supported terminal (hard copy terminals preferred). 

TAPE One 9- track magtape drive. 

or 

DISK RK05, RK06, RK07 or RL01 drive. 

DISK SPACE 2300 free blocks must be available in the target account for 
DATATRIEVE-11. 



3.2 Procedures for Installing DATATRIEVE-11 on RSX-11M V03 

3.2.1 Summary of Installation Procedures 

1. Log in under a privileged account ([l,x]). 

2. Physically mount the distribution medium as described in Chapter 1. 

3. Allocate (and mount, if disk) the distribution medium. 

4. Copy the distribution medium into your account (then remove the distri- 
bution medium). 

5. Execute the command file DTR11M.CMD. 

6. Log off the system. 



3.2.2 Log in Under a Privileged Account 

Log into your computer system under a privileged account in the form [l,x] 

3.2.3 Allocate (and Mount, if Disk) the Distribution Medium 

x. For magtape uistnuution use tue commanu 

ALL deu : (ret) 
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2. For disk cartridge distribution use the commands 

ALL Je"0"! "EST 

MOU devsDTRll ® 

where dev: is the device specification of the drive containing the distribution 
medium. 

3.2.4 Copy the Distribution Medium 

1. To copy the data on the magtape into the target account type the command 

FLX SY:/RSX = dev: [1 »i:*.*/DOS (® 

2. To copy the data on the disk cartridge into the target account type the 
command 

P I P S Y : / N V= d e v : C 1 » 1 3 * ♦ * © 
At this time, data on the distribution medium is copied into the target 

atvuuuu Tnicii mc i/up^mg upciowuii io ^umpictc, mc piuiiipt s appeals un 

v our terminal 

To logically dismount the magtape distribution medium, type the command 

DEA dev: (H) 



For the disk distribution, type the commands 

DM0 deu: W> 
DEA den: (HD 

When the prompt appears on your terminal, remove the distribution medium 
and store it in a safe place. 

The installation dialog to this point will be similar to the following example 
(magtape distribution): 

>ALL MM1: 

>FL)< SY:/RSX=MM1 : CI » 1 ] * »*/DOS 

>DEA MM1 : 



3.2.5 Executing the Command File DTR11M.CMD 

Now type 

SDTRliM m 

DTR11M.CMD is the command file that installs DATATRIEVE-11 into your 
system. As part of the command file, the DATATRIEVE-11 Acceptance Test 
is executed. During the Acceptance Test, you are required to enter data. 
Observe the test as it outputs and respond as the test requests input. 
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The following example is the log printed as a result of command file execu- 
tion. Note that the Acceptance Test has been deleted from the example. The 
complete Acceptance Test is in Appendix A. 



>6DTR11M 

> r 

>i COPY TASK BUILD COMMAND FILES 

> t 

>REM ♦♦♦DTR 

rem — task not in system 
>f'ip lb j c 1 f 24d/nv=qe1 1m ♦ tkb 
>pip qehm»tkb;*/de 

>PIP LB I C 1 f 24 3/NV=QEl 1M ♦ ODL 

>PIP QEllM.ODLr*/DE 

>P I P LB X C 1 r 24 :i /NV=DTR 1 1 M ♦ TKB 

>PIP DTR11M.TKB?*/DE 

>P IP LB J C 1 1 24 3 /N V=DTR 1 1 M . ODL 

>PIP DTR11M.0DL»*/DE 

>P IP LB 1 1! 1 f 243 /N V===RMS 1 1 M . ODL 

>PIP RMS11M.0DL»*/DE 

>PIP LB I I! 1 f 24 3/NV=QCl 1M . TKB 

>PIP QC11M.TKBJ*/DE 

>PIP LB J L 1 , 24 3/NV==GCl 1M * ODL 

>PIP QCl.1.M.ODLr*/DE 

> ! 

>! INSTALL DATATRIEVE OBJECT LIBRARY 

> I 

>MAC QD=QD11M 

>LBR DTRLIB/IN-QD 

>PIP LB:Cl»13/NV=DTRLIB.OLB 

>PIP DTRLIB.OLBr*/DE 

>PIP QD.OBJ?*/DE 

> I 

>! INSTALL DATATRIEVE TASKS 

> I 

'•TKB 6QD11M.TKB 
>RUN QDICT 

CREATING QUERY DICTIONARY 
CREATING MESSAGE FILE 
POPULATING MESSAGE FILE- 
BYE 

>TKB eLBJCl»24 3DTRHM.TKB 
>TKB BLB:C1»243QE11M.TKB 
>TKB 6LB:Cl»243QCliM.TKB 
>INS LB : CI , 54 3 DTR 

> I 

>! RUN DATATRIEVE ACCEPTANCE TEST 

> I 

>DTR ti?DTR.TST 



=2gj The DATATRIEVE-11 Acceptance Test Procedure 



^s^a . , . , . A ,. A 

lO 1/V11VU111VU 111 X 1UL/W11U1A A X. 

>PIP LB I C 1 , 23 /NV= YACHT . DAT 
>PIP YACHT. DAT? */DE 

> I 

::■-• END OF DATATRIEVE INSTALLATION 

> j 

>@ <EOF> 
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3.2.6 Log Off the System 

Log offthe 'system atterthe "DTR1TM.CMD ""file' "Has completed execution (you 
observe the > prompt). 



3.3 DATATRIEVE-11 Files 



When DATATRIEVE-11 has been installed the following files reside in the 
indicated UIC's. Note that the [SELF] designation represents your privileged 
account. 



UIC 


FILE NAME 


[1,1] 


DTRLIB.OLB 


[1,24] 


DTR11M.ODL 


[1,24] 


DTR11M.TKB 


[1,24] 


QC11M.ODL 


[1,24] 


QC11M.TKB 


[1,24] 


QE11M.ODL 


[1,24] 


QE11M.TKB 


[1,24] 


RMS11M.ODL 


[1,2] 


QUERY.DIC 


[1,2] 


QUERY.MSG 


[1,2] 


YACHT.DAT 


[1,34] 


DTR.MAP 


[1,34] 


QCPRS.MAP 


[1,34] 


QDEXT.MAP 


[1,54] 


DTR.TSK 


[1,54] 


QCPRS.TSK 


[1,54] 


QDEXT.TSK 


[SELF] 


DTR.TST 


[SELF] 


MSGS.SEQ 


[SELF] 


QD11M.MAC 


[SELF] 


QD11M.ODL 


[SELF] 


QD11M.TKB 


[SELF] 


QDICT.MAP 


[SELF] 


QDICT.TSK 


[SELF] 


YACHT.SEQ 



DESCRIPTION 

Datatrieve object library 

Datatrieve overlay description file 

Datatrieve task-build command file 

COMPRESS program overlay description file 

COMPRESS program task-build command file 

EXTEND program overlay description file 

EXTEND program task-built command file 

RMS overlay description file 

Data dictionary 

Message file 

Aceptance test data file 

Datatrieve map file 

Dictionary COMPRESS program map file 

Dictionary EXTEND program map file 

Datatrieve task image 

Dictionary COMPRESS program 

Dictionary EXTEND program 

Acceptance test command file 

Message file (distribution format) 

Dictionary file-name source module 

Dictionary build program overlay description file 

Dictionary build program task-build command file 

Dictionary build program map file 

Dictionary build program 

Acceptance test data file (distribution format) 
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Chapter 4 

RSTS/E V06C Installation Procedures 



This chapter is a guide to the installation of DATATRIEVE-11 on the RSTS/E 
V06C Operating System. 

The information in the chapter is organized in the following manner: 

Section 4. 1 presents both the software and hardware requirements needed to 
install DATATRIEVE-11. 

Section 4.2 contains the procedures to install DATATRIEVE-11 on your system. 
Section 4.3 lists the DATATRIEVE-11 files that reside in the target accounts. 



4.1 System Requirements 



The software and hardware listed in Sections 4.2.1 and 4.2.2 respectively are 
required to install DATATRIEVE-11. 

4.1.1 Software Requirements 

RSTS/E, Version V06C 

RSX.RTS - The RSX run-time system 

RT.RTS - The RT-11 run-time system 

SYSLIB.OLB - The RSX system object library 

RMS11.RTS - The RMS-11 run-time system 

PIP.SAV - Peripheral Interchange Program in account [1,2] 

TKB.TSK - The Task Builder in account [1,2] 

MAC.TSK - The MACRO-11 assembler in account [1,2] 

RMS-11K - Version 1.5 (for RMS Indexed Record I/O) 

RMS-11K software must be present on your computer prior to installing 
DATATRIEVE-11. If RMS-11K is not present, you must install it before 
installing DATATRIEVE-11. Get the kit containing the RMS-11K software, 
and install this software following the procedures presented in the RMS-11K 
RSTS/E Installation Guide. 
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4.1.2 Hardware Requirements 

The following system configuration is required for DATATRIEVE-11 
installation. 

CPU PDP-11 with EIS hardware. 

MEM ORY 64K bytes above the minimum operation system requirements . 

TERMINAL Any supported terminal (hardcopy terminals are perferred). 

TAPE One 9-track magtape drive. 

or 

DISK RK05, RK06, RK07 or RL01 drive. 

DISK SPACE 2300 free blocks must be available in the target account for 
DATATRIEVE-11. 



4.2 Procedures for Installing DATATRIEVE-11 on RSTS/E V06C 

4.2.1 Summary of Installation Procedures 

1. Log in under a privileged account [l,x]. 

2. Physically mount the distribution medium as described in chapter 1. 

3. Logically assign the magtape or mount the disk distribution medium. 

4. Copy the distribution medium into your account (then remove the 
distribution) . 

5. Execute the BUILD program. 

6. Log off the system. 

4.2.2 Log in Under a Privileged Account 

Log into your computer system under a privileged account in the form [l,x]. 

4.2.3 Logically Assign the Magtape or Mount the Disk 
Distribution Medium 

1. For magtape distribution use the command 
ASSIGN deu : ♦DOS (H) 

2. For disk cartridge distribution use the command 

MOUNT dev:DTRU/R0NLY © 

where dev: is the device specification of the drive containing the distribution 
medium. 
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4.2.4 Copy the Distribution Medium 



To copy the data on either the magtape or disk distribution into the target 
account type the commands 

RUN *PIP.SAV ® 
**,*=dev:Cl»l]*.* © 

* •'• Z 

At this time, data on the distribution medium is copied into the target 
account. When the copying operation is complete, the prompt Ready appears 
on your terminal. 

To logically dismount the magtape distribution medium, type the command 

DEASSIGN dev: © 

For the disk distribution, type the command 

DISMOUNT dev.DTRll © 

When the Ready prompt appears on your terminal, remove the distribution 
medium and store it in a safe place. 

The installation dialog to this point will be similar to the following example 
(magtape distribution). 

Read v 

ASSIGN MMO: .DOS 
Read y 

RUN $PIP.SAU 

* *,* = MMO: C 1 1 1]*.* 

* -z 

Read y 

DEASSIGN MMO: 
Read v 

4.2.5 Executing the BUILD Program 

Now type 

RUN $BUILD © 

The computer initiates the following dialog; respond as shown. 

BUILD VOBC-03 RSTS V06C-03 SYSTEM 52547 

System Build <No>? ® 

Source Input Device <SY:>? © 

Library Output Device <SY>? © 

Library Account < C 1 » 2 3 >? © 

Control File is? DTRSTS.CTL © 

*** Copy intf file SY : DTRSTS . CTL to SY-.BUILD.TMP 

BUILD Detaching, , . 
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The BUILD program then installs DATATRIEVE-11. The dialog continues, 
as shown by the following example. Note that you must enter the command 
DTR ©DTR.TST to run the Acceptance Test. 

"X 
HELLO 

RSTS V06C-03 Basic +2/Cobol Job 17 KB20 29-AuS-'78 12: 42 PM 

* 1/250 

Password: 

Job .12 is detached under this account 

Job number to attach to? 

1 other user is losJSed in under this account 



Ready 

ASSIGN SYiSVSDSK . 

Ready 

ASSIGN SYt SYSTEM 

Read'; 

assign ;:t ? 2:i 

Ready 

ASSIGN SY: INPUT 

Re<idy 

i 

i hake sure- PXS+RTS and RT11*RTS sre present, 
i 

RUN *UTILTY 

UTILTY V06O03 RSTS VOAC-03 Basic + 2/C;eboI 

♦ADD RSX 

?Name or account now exists •• in ADD 

♦ADD RTU 

? w .;;•? iii » or account now exists •• in ADD 

*CCL DTR- 

? C a n ' t f i r i d f i 1 e o r a c c o u n t - i n C C L 

•IEXIT 

Ready 

i 

! I r i •;.:. t a 1 1 D a t a t f ■ :i. eve a b J e c t 1 i b r ■ a r y 
j 

RUN $MAC 

MAOQD=QDRSTS 

MAO"C 

Ready 

RUN *LBR 

L B R > D T R L I B / 1 N - Q I'l 

LB FTC 
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Ready 

run *pip.sav 
*lb:=dtrlib.olb 

*DTRLIB.OLB/IiE 
*QD.OBJ/DE 

*lb:rmsii*tsk<40>/re 

♦ "C 
Ready 

! 

' I n s 1 3 1 1 D 3 1 a t t i & / >:■ I a s k s 
! 

RUN $TKB 
TKB>@QDRSTS.TKB 

Ready 

RUN QD'ICT 

CREATING QUERY DICTIONARY 

CREATING MESSAGE FILE 

POPULATING MESSAGE FILE! 

BYE 

Ready 

RUN *TKB 
TKB>@DTRSTS.TKB 

Ready 

R(_]jq $TKB 
TKB>@QERSTS.TKB 

Ready 

RUN *TKB 
TKB>@QCESTSFTKB 

Ready 

RUN * UTILITY 

UTIETY V06C-03 RSTS V06C-03 Basicf 2/CoboI 

*ccl dtr-=system:@dtr * TSK 

♦EXIT 
Ready 

! 

! Clean up accounts 
! 

$PIP*SAV 
♦SYSTEM :@<104>=BTR* TSK 
♦SYSTEM J 0=QDEXT . TSK 
♦SYSTEM t GNQCPRS * TSK 
♦DTR.TSK/DE 
♦QDEXT.TSK/DE 
♦QCPRS.TSK/DE 
♦SYSTEM J ©QUERY , DIG <0>/RE 
♦SYSTEM: ©QUE RY»MSG<40>/RE 
♦T 
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Ready 



! Ready to run Datat i ieve acceptance test* 

C 

Ready 

HELLO 

R S T S M 6 C - 3 B a s i c + 2 / C o b o I J o b 1. 7 C 1 t 2 5 3 K B 2 2 9 -••• A u si ~ 78 1 2 J 5 6 P M 
Job .1.2 is detached under this account 
Job number to attach to' !> 12 
Attaching to Job 1.2 

BUILD Complete 

Ready 

DT'R eiHR.TST 



c^j The DATATRIEVE-11 Acceptance Test Procedure 
is contained in Appendix A. 



Part of the BUILD program's processing is the DATATRIEVE-11 Acceptance 
Test. You must enter data at the points shown in Appendix A to execute this 
test properly. 

At the completion of the Acceptance Test, look for the lines 



END OF QUERY/REPORT WRITER TEST 



EXIT 
BYE 

Ready 



Next type the following under "Ready" 

RUN *PIP.SAV © 
*$<40>=YACHT,DAT ® 

Watch for the prompt Ready to appear. After "Ready" prints out, log off your 
system. DATATRIEVE-11 has been installed. 
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4.3 DATATRIEVE-11 Files 



WlIen""DATATEIEVE-tt"lIas been instaTled, tfie~fbHo\wng 'files reside in The 
indicated accounts. Note that the [SELF] designation represents your privi- 
leged account. 



ACCOUNT FILE NAME 



DESCRIPTION 



[1,1] 


DTRLIB.OLB 


[1,2] 


DTR.TSK 


[1,2] 


QCPRS.TSK 


[1,2] 


QDEXT.TSK 


[1,2] 


QUERY.DIC 


[1,2] 


QUERY.MSG 


[1,2] 


YACHT.DAT 


[SELF] 


DTR.MAP 


[SELF] 


DTR.TST 


[SELF] 


DTRSTS.ODL 


[SELF] 


DTRSTS.TKB 


[SELF] 


MSGS.SEQ 


[SELF] 


QCPRS.MAP 


[SELF] 


QCRSTS.ODL 


[SELF] 


QCRSTS.TKB 


[SELF] 


QDEXT.MAP 


[SELF] 


QDICT.MAP 


[SELF] 


QDICT.TSK 


[SELF] 


QDRSTS.MAC 


[SELF] 


QDRSTS.ODL 


[SELF] 


QDRSTS.TKB 


[SELF] 


QERSTS.ODL 


[SELF] 


QERSTS.TKB 


[SELF] 


RMSRST.ODL 


[SELF] 


YACHT.SEQ 



Datatrieve object library 

Datatrieve task image 

Dictionary COMPRESS program 

Dictionary EXTEND program 

Data dictionary 

Message file 

Acceptance test data file 

Datatrieve map file 

Acceptance test command file 

Datatrieve overlay description file 

Datatrieve task-build command file 

Message file (distributon format) 

Dictionary COMPRESS program map file 

COMPRESS program overlay description file 

COMPRESS program task-build command file 

Dictionary EXTEND program map file 

Dictionary build program map file 

Dictionary build program 

Dictionary file-name source module 

Dictionary build program overlay description file 

Dictionary build program task-build command file 

EXTEND program overlay description file 

EXTEND program task-build command file 

RMS overlay description file 

Acceptance test data file (distribution format) 
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Chapter 5 

Compressing the Data Dictionary and Extending 
DATATRIEVE-11 



This chapter contains procedures you can use to: 

1. Compress the data dictionary 

2. Extend DATATRIEVE-11 task space 

3. Extend (temporarily) the data dictionary 

5.1 Compressing the Data Dictionary 

You use the utility program, QCPRS, to periodically compress the data dic- 
tionary. As DATATRIEVE-11 is used, the data dictionary can accumulate 
deleted record headers, deoptimized index structures and scattered and frag- 
mented buckets; run QCPRS to reclaim the disk space wasted by this frag- 
mentation. 

To run QCPRS, invoke the program with the operating system command: 

RUN QCPRS m 

The utility program responds with the prompt: 

CPR> 

To compress the data dictionary, enter the command line in the form 

new -file=o Id-file 

to QCPRS, where old-file is the file name of the data dictionary, and new-file 
is the name of the compressed copy of the dictionary. 
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The default file name for both new-file and old- file is SY:QUERY.DIC; the 
UIC (or account) defaults to your directory. 

On RSX-11M and IAS systems, new- file and old- file can have the same 
name; either system creates a new version of the name. Under RSTS/E, 
however, the name must be different. The best strategy is to rename the 
dictionary to a suitable name, such as QUERY. BAK, and use QCPRS to copy 
it back to its original name, QUERY.DIC. 

QCPRS then prompts for an initial allocation for the new version of the file 
with the message: 

ENTER ALLOCATION FOR AREA 0: 

Enter a "best guess" for the new compressed version. If the value entered is too 
low, the file will be extended automatically to hold the contents of the original 
file. 

To terminate QCPRS, type (ctrl/z) after the prompt CPR>. 

The original file is not altered by QCPRS. It may be saved as a backup or 
deleted. 

An example of a typical QCPRS run follows: 

RUN QCPRS (RET) 

QUERY FILE COPY-COMPRESS UTILITY 

CPR> QUERY.DIC = SY:C1»2] QUERY.DIC © 

ENTER ALLOCATION FOR AREA 0: 250 (H) 

CPR> (CTRpz) 



5.2 Extending DATATRIEVE-11 Task Space 

DATATRIEVE-ll utilizes extend task space for RMS buffers, internal con- 
trol blocks, and SORT work space. When this space is exhausted during 
execution of a command, one of the following messages is printed: 

CENTRAL STORAGE POOL EXHAUSTED 
SORT WORK SPACE EXHAUSTED 
COMPILER STORAGE POOL EXHAUSTED 

There are two solutions to this problem. First, the amount of memory in use 
can be reduced by taking one or more of the following steps: 

1. Use the RELEASE command to release any unnecessary collections. 

2. Use the FINISH command to finish any unnecessary domains. 

3. If any DEFINE or DELETE commands have been issued, exit and re- 
invoke DATATRIEVE-11. 

Second, if the problem persists, the extend task size parameter in the 
DATATRIEVE-11 task build command file can be modified to increase the 
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size of DATATRIEVE-11. To do this, edit the file DTRIAS.TKB (IAS 
System), or PTE11.M,TKB (BSX-llM.SystemXflr.inESTS,TJCa4RST-S^ 
System). The syntax of the extend task size parameter is: 

EXTTSK=x xxxx 

where xxxxx is the number of decimal words that the task is to be extended. 
Next, rebuild DATATRIEVE-11 with the command(s): 

BDTRIAS.LNK ® (for IAS System) 

RUN $TKB m (for RSX-11M System) 

TKB> @DTR11M.TKB © 

RUN $TKB m (for RSTS/E System) 

TKB> @DTRSTS,TKB © 

Upon completion of the task build, DATATRIEVE-11 is ready for execution. 

5.3 Extending the Data Dictionary 

When DATATRIEVE-11 is installed in an RSX-11M System, RMS automat- 
ically extends the data dictionary file, should that file become full. However, 
all RSTS/E systems (and some IAS Systems) will return error messages indi- 
cating that the data dictionary is full. 

The reason for the message is that in RSTS/E Systems (and some IAS Sys- 
tems) any attempt to extend a file by a user who is not the owner of the file is 
rejected by RMS. 

To extend the size of the data dictionary, you can use the QDEXT utility 
program. Run the program by typing 

RUN QDEXT 

QDEXT then prompts for the name of the file (the data dictionary) and the 

number of blocks it is to be extended. 

» 

5.4 Automatic Spooling Under RSX-11M 

Automatic line printer spooling under RSX-11M is controlled by the global 
symbol SPL11M. If this symbol is set to 1 (as distributed), all PRINT and 
REPORT command references to the device LP: are redirected to disk, and 
queued to the spooler following request execution. If the symbol SPL11M is 
set to 0, line printer output is sent directly to the line printer. 

The SPL11M symbol is defined in the RSX-11M DATATRIEVE Task Build 
Command File DTR11M.TKB. To send line printer output directly to the line 
printer, edit the DTR11M.TKB file (setting SPL11M to 0), then run the Task 
Builder: 

RUN $TKB m 
TKB>@DTR11M.TKB ffi} 
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Appendix A 

Acceptance Test Procedure 



i 

! CLEAN UP FROM POSSIBLE PREVIOUS RUNS OF TEST 
i 

DELETE YACHTS-SEQUENTIAL 9 

"YACHTS- SEQUENTIAL' has not been defined in the dictionary 

DELETE YACHTS? 

" Y A C H T S " h a s n o t been d e f i n e d i n the d i c t i o n a r y 

DELETE YACHT ? 

"YACHT" has not been defined in the dictionary 

.U t. L. fc. I L r r\ j. w c " r r. ia — r u u i s .1.1 y 

■ P R I C E - P E R - P U N D " h a s n o t b e e n d e f i n e d i n t h e d :L c t i o n a r y 

DELETE STORE-YACHT J 

"STORE! -YACHT" has not been defined in the dictionary 

D E L E T E I... A •••■ R E P R T ? 

" L A - R E P R T " h a s n o t b e e n d e f i n e d i n t h e d i c t i o n a r y 

1 

! DEFINE RECORD 

'} 

DEFINE RECORD YACHT USING 
01 BOAT* 
03 TYPE* 

06 MANUFACTURER PIC X<10) 
QUERY -NAME IS BUILDER* 
06 MODEL PIC XCLO) * 
03 SPECIFICATIONS 

QUERY-NAME SPECS * 

06 RIG PIC X(6) ♦ 

06 LENGTH-OVER- ALL PIC XXX 

QUERY-NAME IS LGA. 
06 DISPLACEMENT PIC 99999 
QUERY-HEADER IS "WEIGHT" 
ED IT-STRING IS ZZ.*ZZ9 
QUERY-NAME IS DISP. 
06 BEAM PIC 99* 
06 PRICE PIC 99999 

EDIT-STRING IS $$$,$*$ ♦? 
I! Re cord YACHT is 41 bytes Ion a 3 

DEFINE DOMAINS 

DEFINE DOMAIN YACHTS-SEQUENTIAL USING YACHT ON YACHT ♦SEQ t 
EFINE DOMAIN YACHTS USING YACHT ON YACHT* DAT? 

DEFINE THE ACTUAL FILE FOR YACHTS 

DEFINE FILE YACHTS KEY=BUILDER ( DUP ) 9 KEY=MODEL ( DUP »CHANGE ) f 
ALLOCAT 1" 0N = 30 5- SUPERCEDE 
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PASSWORD FOR WRITE 

EVERYONE ELSE GETS READ 

GIVE ACCESS TO RECORD DEFINITION* TOO 



! MAKE YACHTS ACCESSABLE BY OTHERS 
! 

DEFINEP YACHTS 2 *PW* "SHHHH" * W 
DEFINEP YACHTS 3 *UIC * I:***] * R 
DEFINEP YACHT 2»UIC»C*»*3»R 
SHOWP YACHTS 

.1. * u i c * c 3 1 1 * 300 ::i * " rwmec ■ 

2*PW* "SHHHH"* "W" 

3*uic? i::***:]* -r- 

i 

I EiEFINE PROCEDURES 
! 

DEFINE PROCEDURE PRICE-PER-POUND 

PR I CE* 1 ♦ 00/D I SP ( " PR I CE " / " PER " / " POUND " ) US I NG ** ♦ 99 

END-PROCEDURE 

! 

DEFINE PROCEDURE STORE- YACHT 
STORE YACHTS VERIFY USING 
BEGIN 

IF BEAM EQ THEN ABORT "BAD BEAM" 

IF DISP EQ THEN ABORT "BAD DISPLACEMENT" 

IF LOA NOT BETWEEN 20 AND 60 THEN ABORT "BAD LENGTH" 

PRINT 

DISPLAY "CONFIRM WITH Y IF OK" 

IF *♦ CONFIRMATION NOT CONTAINING " Y • THEN ABORT "STORE ABORTED 
END 
END-PROCEDURE 
! 

! COPY DATA FROM SEQUENTIAL TO INDEXED FILE 

READY YACHTS WRITE 
READY YACHTS-SEQUENTIAL 
SHOW READY 
Ready domains* 

YACHTS-SEQUENTIAL? RMS SEQUENTIAL* PROTECTED READ 

YACHTS: RMS INDEXED* PROTECTED WRITE 

FOR YACHTS-SEQUENTIAL STORE YACHTS USING BOAT^BOAT 

FINISH YACHTS-SEQUENTIAL* 

TEST STORE 

PLEASE SUPPLY THE FOLLOWING VALUES! 

MANUFACTURER : HINKLEY 

MODEL J BERMUDA 40 

rig: YAWL 

length-over-all: 140 

displacement: 20000 

beam: 12 

price: 82000 

: STORE-YACHT 

Enter MANUFACTURER: HINKLEY 

Enter MODEL: BERMUDA 40 

Enter RIG: YAWL 

Enter LENGTH-OVER-ALL : 140 

Enter DISPLACEMENT: 20000 

Enter BEAM: 12 

Enter PRICE: 82000 

ABORT: BAD LENGTH 

Execution term ins ted by "ABORT" statement 

i 
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PLEASE SUPPLY THE FOLLOW VALUES? 



MANUFACTURER I 


HTNKCEY 




model: 


BERMUDA 


40 


rig: 


YAWL 




LENGTH-OVER-ALL J 


40 




displacement: 


20*000 




beam: 


1 <c 




price: 


$82*000 




CONFIRMATION 


N 





: STORE- YACHT 

Enter MANUFACTURER: HINKLEY 

Enter MODEL : BERMUDA 40 

Enter RIG: YAWL 

Enter LENGTH -OVER-ALL t 40 

Enter DISPLACEMENT: 20* 000 

Enter BEAM: 12 

Enter PRICE :*S2* 000 



MANUFACTURER 



MODEL 



LENGTH 
OVER- 
RIG ALL WEIGHT BEAM PRICE 



20*000 12 $82*000 



hinkley bermuda 40 yawl 40 
display: confirm with y if ok 

Enter CONFIRMATION :N 

abort: store aborted 

Execution terminated by "ABORT" statement 
! 

! CHANGE READY MODE FOR READ ACCESS 
j 

READY YACHTS 

FIND YACHTS WITH PRICE NE 

C52 records found II 

SORT BY LOAvDESC DISPLACEMENT 

SHOW ALL 

Domains: 

YACHTS-SEQUENTIAL 

YACHTS 
Records: 

YACHT 
Procedures: 

PRICE-PER-POUND 

STORE-YACHT 
Collections: 

CURRENT 
Ready domains: 

YACHTS: RMS INDEXED* PROTECTED READ 
SHOW CURRENT 
Collection CURRENT 

Domain: YACHTS 

Number of records: 52 

No selected record 

Sort order: LENGTH-OVER-ALL* DISPLACEMENT 
PRINT ALL 
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LENGTH 
















OVER- 










ANUFACTURER 


MODEL 


RIG 


ALL 


WEIGHT 


BEAM 


PRICE 


WINDPOWER 


IMPULSE 


SLOOP 


16 




650 


07 


$3*500 


CAPE DORY 


TYPHOON 


SLOOP 


19 


li 


900 


06 


$4*295 


VENTURE 


21 


SLOOP 


21 


1> 


500 


07 


$2*823 


VENTURE 


oo'p 


SLOOP 


W 


2 ! 


000 


07 


$3*564 


EASTWARD 


HO 


M/S 


24 


7i 


000 


09 


$15*900 


ISLANDER 


BAHAMA 


r*> i r\ r\ r» 

oLuur 




A 

*t 5 


-200 


An 


$6*500 


IRWIN 


25 


SLOOP 


25 


5 


400 


12 


$10*950 


CAPE DORY 


25 


SLOOP 


25 


4! 


-000 


07 


$S * 995 


SALT 


19 


SLOOP 


25 


':> , 


-600 


07 


$6*590 


WESTERLY 


CENTAUR 


SLOOP 


26 


6 


'700 


08 


$15*245 


GRAMPIAN 


26 


SLOOP 


26 


5 


-600 


OS 


$11*495 


AMERICAN 


26-MS 


M/S 


26 


5) 


500 


08 


$18*895 


TANZER 


26 


SLOOP 


26 


4 


350 


09 


$11*750 


ALB IN 


79 


SLOOP 


26 


4 


-200 


10 


$17*900 


AMERICAN 


26 


SLOOP 


26 


4 


'000 


08 


$9*895 


HUNTER- 


27 


SLOOP 


27 


6 


'500 


09 


$14*999 


ALB IN 


VEGA 


SLOOP 


27 


5 


'070 


08 


$18*600 


CAPE DORY 


28 


SLOOP 


28 


9 


'000 


09 


$21*990 


SABRE 


28 


SLOOP 


28 


7 


'400 


09 


$22*000 


GRAMPIAN 


28 


SLOOP 


28 


6 


'900 


10 


$14*475 


TANZER 


28 


SLOOP 


28 


6 


'800 


10 


$17*500 


ISLANDER 


28 


SLOOP 


28 


5 


'994 


10 


$15*908 


NORTHERN 


29 


SLOOP 


29 


7 


'250 


09 


$20*975 


IRWIN 


30 


SLOOP 


30 


10 


-000 


10 


$19*950 


HUNTER 


30 


SLOOP 


30 


9 


'500 


10 


$21*500 


GRAMPIAN 


30 


SLOOP 


30 


8! 


'600 


09 


$17*775 


ISLANDER 


30 


SLOOP 


30 


8 


'600 


10 


$20*990 


ALBIN 


BALLAD 


SLOOP 


30 


7 


'276 


10 


$27*500 


CLIPPER 


CM 30 


SLOOP 


30 


3 


'800 


08 


$9*500 


RYDER 


S* CROSS 


SLOOP 


31 


13 


'600 


00 


$32*500 


BOMBAY 


CLIPPER 


SLOOP 


31 


9 


'400 


11 


$23*950 


WRIGHT 


SEAWIND II 


SLOOP 


32 


14 


'900 


00 


$34*480 


CHALLENGER 


32 


SLOOP 


32 


12 


-800 


11 


$31*835 


O'DAY 


32 


SLOOP 


32 


11 


'000 


00 


$29*500 


BAYFIELD 


30/32 


SLOOP 


32 


9 


'500 


10 


$32*875 


CLIPPER 


CM 32 


SLOOP 


32 


4 


'500 


08 


$12*950 


GRAMPIAN 


34 


KETCH 


33 


12 


'000 


10 


$29*675 


GRAMPIAN 


2-34 


SLOOP 


34 


11 


'800 


10 


$29*675 


CARIBBEAN 


35 


SLOOP 


35 


18 


'000 


11 


$37*850 


CHRI8--CRAF 


CARIBBEAN 


SLOOP 


35 


18 


• 000 


11 


$37*850 


CHALLENGER 


35 


SLOOP 


35 


14 


-800 


12 


$39*215 


I* TRADER 


37 


KETCH 


36 


18 


' 600 


12 


$39*500 


ISLANDER 


36 


SLOOP 


36 


13 


'450 


11 


$31*730 


ALBERG 


37 MK II 


KETCH 


37 


20 


'000 


12 


$36*951 


IRWIN 


37 MARK II 


KETCH 


37 


20 


'000 


11 


$36*950 


NORTHERN 


37 


KETCH 


37 


14 


'000 


11 


$50*000 


LINDSEY 


39 


M/3 


39 


14 


' 500 


12 


$35*900 


CHALLENGER 


41 


KETCH 


41 


26 


r700 


13 


$51*228 


GULFSTAR 


41 


KETCH 


41 


'? ':> 


rOOO 


12 


$41 »350 


ISLANDER 


FREEPORT 


KETCH 


41 


oo 


'000 


13 


$54*970 


COLUMBIA 


41 


SLOOP 


41 


20 


'700 


11 


$48*490 


OLYMPIC 


ADVENTURE 


KETCH 


42 


24 


'250 


13 


$80*500 



A-4 Acceptance Test Procedure 



SELECT FIRST 
PRINT 

MANUFACTURER MODEL RIG 
WINDPOUER IMPULSE SLOOP 

SELECT 

PRINT BOAT* JPRICE-PER-POUND 



MANUFACTURER MODEL RIG 
CAPE DORY TYPHOON SLOOP 



LENGTH 
OVER 
ALL WEIGHT BEAM PRICE 



16 



650 07 



$3*500 



LENGTH PRICE 

OVER PER 

ALL WEIGHT BEAM PRICE POUND 



19 



1*900 06 $4*295 $2*26 



DEFINE REPORT PROCEDURE 

DEFINE PROCEDURE LOA-REPORT 
REPORT ON **FILE 

SET REPORT~NAME=" JIM'S VERY OWN LISTINGVOF"/" INTERESTING SAILBOATS'/ 

"(BY LENGTH) " 
SET LINES-PAGE=55* C0LUMNS-PAGE=72 
AT TOP OF LOA PRINT LOA( "LENGTH" ) 
PRINT TYPE* RIG* DISP* BEAM USING Z9 * PRICE 
AT BOTTOM OF LOA PRINT SKIP* COL 32* "*** AVERAGE ***"* 

AVERAGE DISP* AVERAGE BEAM* AVERAGE PRICE 
AT BOTTOM OF REPORT PRINT SKIP* "REPORT AVERAGES"* 

AVERAGE DISP* AVERAGE BEAM* AVERAGE PRICE 
AT BOTTOM OF PAGE PRINT SKIP* COL 20* 

"'"ANOTHER SERVICE OF QUERY ENTERPRISES"*" 
REPORT END 
END-PROCEDURE 

INVOKE REPORT (SUGGEST OUTPUT ON Tin 

: LOA-REPORT 
Enter FILE: TIJ 



Acceptance Test Procedure A-5 



JIM'S VERY OWN LISTING 

OF 

INTERESTING SAILBOATS 

(BY LENGTH) 



3.1. -JUL -78 
PAGE 1 



LENGTH 
16 

.19 

21 



26 



28 



MANUFACTURER 



MODEL 



RIG 



WEIGHT BEAM 



*** AVERAGE *** 



600 



08 



IRWIN 


25 


CAPE DORY 


25 


SALT 


19 



*** AVERAGE *** 



4*000 



08 



*** AVERAGE *** 



058 



08 



*** AVERAGE *** 



08 



CAPE DORY 


23 


SABRE 


28 


GRAMPIAN 


28 


TANZER 


28 


"ANOTHER 


SERVI 



PRICE 



WINDPOWER 


IMPULSE 


SLOOP 


650 


7 


$3 


-500 




a* -a?*** a. i i r- i~i a r* r- 

*** HVCI\HUC 


*** 


O *J \.' 




$3 




CAPE DORY 


TYPHOON 


SLOOP 


1*900 


6 


$4 


-295 




*** AVERAGE 


*#* 


1*900 


06 


$4 


- 295 


VENTURE 


21 


SLOOP 


1*500 


7 


$2 


-823 




*** AVERAGE 


#** 


1*500 


07 


$2 


-823 


VENTURE 


o'?? 


SLOOP 


2*000 


7 


$3 


-564 




*** AVERAGE 


**# 


2*000 


07 


$3 


-564 


EASTWARD 


HO 


M/S 


7*000 


9 


$15 


-900 


ISLANDER 


BAHAMA 


SLOOP 


4*200 


8 


$6 


-500 



$:L1 



SLOOP 


5*400 


12 


$10 


-950 


SLOOP 


4 * 000 


7 


$8 


-995 


SLOOP 


2*600 


7 


$6 


-590 



$8 



WESTERLY 


CENTAUR 


SLOOP 


6*700 


8 


$15 


-245 


GRAMPIAN 


26 


SLOOP 


5*600 


8 


$11 


-495 


AMERICAN 


26-MS 


M/S 


5 * 500 


8 


$18 


-895 


TANZER 


26 


SLOOP 


4*350 


9 


$11 


- 750 


ALBIN 


79 


SLOOP 


4*200 


10 


$17 


-900 


AMERICAN 


26 


SLOOP 


4*000 


8 


$9 


-895 



$14 



HUNTER 


27 


SLOOP 


6*500 


9 


$14*999 


ALBIN 


VEGA 


SLOOP 


5 * 070 


8 


$18*600 



$16 



SLOOP- 




9*000 


9 


$21 


-990 


SLOOP 




7*400 


9 


$22 


- 000 


SLOOP 




/j _ 9QQ 


10 


$14 


-47 / 5 


SLOOP 




6*800 


10 


$17 


-500 


Y ENTE 


RPF 


cises" 









200 



84; 



196 



799 



A-6 Acceptance Test Procedure 



JIM'S VERY OWN LISTING 
OF 



LENGTH 



2? 



30 



32 



33 



34 



36 



INTERESTING SAILBOATS 






31-JUL-78 




(BY LENGTH) 








PAGE 2 


MANUFACTURER 


MODEL 


RIG 


WEIGHT 


BEAf* 


i PRICE 


ISLANDER 


28 


SLOOP 


5? 994 


10 


$15,908 




*** AVERAGE 


#** 


7.218 


09 


$18 y 374 


NORTHERN 


29 


SLOOP 


7*250 


9 


$20,975 




*** AVERAGE 


*## 


7y250 


09 


$20,975 


IRWIN 


30 


SLOOP 


10.000 


10 


$19,950 


HUNTER- 


30 


SLOOP 


9 9 500 


10 


$21 y 500 


GRAMPIAN 


30 


SLOOP 


8x600 


9 


$17,775 


ISLANDER 


30 


SLOOP 


8? 600 


10 


$20,990 


ALBIN 


BALLAD 


SLOOP 


7.276 


10 


$27,500 


CLIPPER 


CM 30 


SLOOP 


3 y 800 


8 


$9,500 




*** AVERAGE 


*** 


7y962 


09 


$19,535 


RYDER 


S* CROSS 


SLOOP 


13 y 600 





$32,500 


BOMBAY 


CLIPPER 


SLOOP 


9.400 


11 


$23 y 950 




*** AVERAGE 


**# 


11 y 500 


05 


$28 y 225 


WRIGHT 


SEAWIND II 


SLOOP 


14 y 900 





$34,480 


CHALLENGER 


32 


SLOOP 


12 y 800 


11 


$31 y 835 


' DAY 


32 


SLOOP 


11 yOOO 





$29 y 500 


BAYFIELD 


30/32 


SLOOP 


9y500 


10 


$32 y 875 


CLIPPER 


CM 32 


SLOOP 


4 y 500 


8 


$12,950 




*** AVERAGE 


### 


10 y 540 


05 


$28,328 


GRAMPIAN 


34 


KETCH 


12 y 000 


10 


$29,675 




*** AVERAGE 


*** 


12 y 000 


10 


$29,675 


GRAMPIAN 


2-34 


SLOOP 


11.800 


10 


$29 y 675 




*** AVERAGE 


*## 


11 y 800 


10 


$29,675 


CARIBBEAN 


35 


SLOOP 


IS , 000 


11 


$37,850 


CHRIS-CRAF 


CARIBBEAN 


SLOOP 


18y000 


11 


$37,850 


CHALLENGER 


35 


SLOOP 


14.800 


12 


$39,215 




*** AVERAGE 


*** 


16 y 933 


11 


$38,305 


I* TRADER- 


37 


KETCH 


18 y 600 


12 


$39,500 


ISLANDER 


36 


SLOOP 


13y450 


11 


$31,730 




*** AVERAGE 


*** 


16.025 


11 


$35,615 



"ANOTHER SERVICE OF QUERY ENTERPRISES 



Acceotance Test Procedure A-7 



LENGTH 
37 



39 



41 



JIM' 


S VERY OWN LISTING 










OF 










INTERESTING SAILBOATS 






31-JUL-78 




<BY LENGTH) 








PAGE 3 


ANUFACTUREF 


C MODEL 


RIG 


WEIGHT 


BEAM 


PRICE 


ALBERG 


37 MK II 


KETCH 


20? OOO 


12 


$36*951 


IRWIN 


37 MARK II 


KETCH 


20 * 000 


11 


$36*950 


NORTHERN 


37 


KETCH 


14 * 000 


11 


$50*000 




*** AVERAGE 


*** 


18*000 


11 


$41*300 


LINDSEY 


39 


M/S 


14*500 


12 


$35*900 




*** AVERAGE 


*** 


14*500 


12 


$35*900 


CHALLENGER 


41 


KETCH 


26 * 700 


13 


$51*228 


GULFSTAR 


41 


KETCH 


22*000 


12 


$41*350 


ISLANDER 


FREEPORT 


KETCH 


22 * 000 


13 


$54*970 


COLUMBIA 


41 


SLOOP 


20 * 700 


11 


$48*490 




*** AVERAGE 


*** 


22*850 


12 


$49*009 


OLYMPIC 


ADVENTURE 


KETCH 


24*250 


13 


$80*500 




*** AVERAGE 


**# 


24*250 


13 


$80*500 








10*169 


09 


$24*843 



42 



REPORT AVERAGES 



"ANOTHER SERVICE OF QUERY ENTERPRISES" 
INVOKE REPORT (SUGGEST OUTPUT ON LP!) 

ILOA-REPORT 
Enter FILE: LP! 

RATTLE UPDATE- 
FIND YACHTS WITH BEAM^O 
C5 records found!] 
PRINT ALL 









LENGTH 














OVER 








MANUFACTURER 


MODEL 


RIG 


ALL 


WEIGHT 


BEAM 


PRICE 


METALMAST 


GALAXY 


SLOOP 


32 


9*500 


00 




O'DAY 


32 


SLOOP 


32 


11*000 


00 


$29*500 


RYDER 


S. CROSS 


SLOOP 


31 


13*600 


00 


$32*500 


TA CHIAO 


FANTASIA 


SLOOP 


35 


23*200 


00 




WRIGHT 


SEAWIND II 


SLOOP 


32 


14*900 


00 


$34*480 


SELECT FIRST 


5 PRINT 




LENGTH 
OVER- 








MANUFACTURER 


MODEL 


RIG 


ALL 


WEIGHT 


BEAM 


PRICE 


METALMAST 


GALAXY 


SLOOP 


32 


9*500 


00 




READY YACHTS 
i 


MODIFY 













A-8 Acceptance Test Procedure 



! RESPOND WITH 47 (OR SOMETHING) 
j 

HOTJTFY BEAM 
Enter BEAM? 47 
PRINT TYPE , BEAM 

MANUFACTURER MODEL BEAM 

METALMAST GALAXY 47 

RESPOND WITH 48 (OR SOMETHING) 

MODIFY ALL BEAM 
Enter BEAM? 48 
I 

PRINT ALL BEAM 
BEAM 



48 
48 
48 
48 
48 



RESPOND EACH TIME WITH (PLEASE) 
FOR CURRENT PRINT TYPE THEN MODIFY BEAM 
MANUFACTURER MODEL 

METALMAST GALAXY 
Enter BEAM: 

O'DAY 32 
Enter BEAM: 

RYDER S* CROSS 
Enter BEAM: 

TA CHIAO FANTASIA 
Enter BEAM: 

WRIGHT SEAWIND II 
Enter BEAM: 

READY YACHTS READ 
PRINT ALL 



MANUFACTURER 



MODEL 



LENGTH 
OVER- 
RIG ALL WEIGHT BEAM 



PRICE 



METALMAST 


GALAXY 


SLOOP 


32 


9,500 


00 




O'DAY 


32 


SLOOP 


32 


11,000 


00 


$29,500 


RYDER 


S* CROSS 


SLOOP 


31 


13,600 


00 


$32,500 


TA CHIAO 


FANTASIA 


SLOOP 


35 


23,200 


00 




WRIGHT 


SEAWIND II 


SLOOP 


32 


14,900 


00 


$34,480 



CHECK MULTIPLE COLLECTIONS AND STATISTICAL FUNCTIONS 

FIND SMALLS IN YACHTS WITH L0A<24 AND PRICE NE 
C4 records found] 



Acceptance Test Procedure A-9 



I 

FIND BIGGIES IN YACHTS WITH L0A>40 AND PRICE NE 

C5 records found!] 

! 

SHOW COLLECTIONS 
Collections J 

BIGGIES (also CURRENT) 

SMALLS 

! I 

PRINT AVERAGE! DISP 

WEIGHT 

23.130 

! 

PRINT MAX DISP 

WEIGHT 

26 , 700 

j 

PRINT AVERAGE PRICE OF BIGGIES, AVERAGE PRICE OF SMALLS 

PRICE PRICE 
$55? 307 $3,545 

! 

SORT SMALLS BY LOA, DISP 

SORT BIGGIES BY LOA, DISP 

SELECT FIRST SMALLS 

SELECT LAST BIGGIES 

PRINT SMALLS ♦ BOAT , SKIP , BIGGIES ♦ BOAT 

LENGTH 
OVER- 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 

WINDPOWER IMPULSE SLOOP 16 650 07 $3,500 
OLYMPIC ADVENTURE KETCH 42 24 , 250 13 $80 ,500 

FINAL GALA TEST! 

PRINT YACHTS WITH LOA EQ MAX LOA OF YACHTS 

LENGTH 
OVER- 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 

OLYMPIC ADVENTURE KETCH 42 24,250 13 $80,500 
PEARSON 419 KETCH 42 21,000 13 

i 

! END OF QUERY/REPORT WRITER TEST 



A-10 Acceptance Test Procedure 



READER'S COMMENTS 



DATATRIEVE-ll(Vl.l) 
IAS, RSX-11M, RSTS/E 
Installation Guide 

Order Mo. AA-Hie9A-TC 



NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 



Name. 



Date. 



Organization. 

Street 

City 



State 



Zip Code 

or 
Country 



Fold Here 



Do Not Tear - Fold Here and Staple 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 



FIRST CLASS 

PERMIT NO. 33 

MAYNARD, MASS. 



Postage will be paid by: 



Software Documentation 
146 Main Street ML 5-5/E39 



